home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / BlackHole / BlackHole.doc < prev    next >
Text File  |  1996-09-26  |  5KB  |  118 lines
  1.  
  2.             BlackHole by Alan Singfield.
  3.             ----------------------------
  4.  
  5.  What is Black Hole?
  6.  -------------------
  7.  
  8.  Black Hole is a nice little file deletion utility. Double click on it, and a
  9.  clone of its icon will appear on the Workbench screen. Drop an icon onto it and
  10.  it will be deleted (It will ask you first whether it's OK to do this). Double
  11.  click on it's icon and a control panel will appear, which contains the option
  12.  to quit amongst others.
  13.  
  14.  Control Panel
  15.  -------------
  16.  
  17.  Options are --
  18.     Quit        Guess what this does.
  19.     About        Tells you who wrote the program.
  20.     Delete Limit    Max number of files to delete in one go. (Mainly so
  21.             confirmation requester doesn't drop off the bottom of
  22.             the screen)
  23.     Confirm Deletion    If this is on (the default), you will be asked whether
  24.             you really want to delete the files you dropped on the
  25.             icon.
  26.     Ignore Protection    Set this if you want to ignore the delete protection bit
  27.             that some files have set.
  28.     UnSnapshot        Icon can go whereever Workbench wants to put it.
  29.     Snapshot        Remember the current position of the icon.
  30.             This doesn't actually work yet, see later.
  31.     Save        Save all preference settings.
  32.     Use         Use preferences but don't save them.
  33.     Cancel        Forget changes made.
  34.  
  35.  Tooltypes
  36.  ---------
  37.  
  38.  Black Hole also accepts arguments in the ToolTypes of its icon. Indeed, this is
  39.  where it stores all the user preferences. The tooltypes accepted are --
  40.     ICONX        X coordinate of icon.
  41.     ICONY        Y coordinate of icon.
  42.     DELETELIMIT=n    Delete no more than n files.
  43.     DONOTCONFIRM    Don't confirm that its OK to delete (risky).
  44.     IGNOREPROTECTION    Ignore delete protection.
  45.  If you decide to remove any of these, please enclose the line in brackets ()
  46.  rather than deleting the tooltype, so other people know what they are if the
  47.  document is lost.
  48.  
  49.  System requirements
  50.  -------------------
  51.  
  52.  Black Hole requires v2.04 or greater of the operating system. (And a few bytes
  53.  of RAM & disk space)
  54.  
  55.  Version History
  56.  ---------------
  57.  
  58.     v1.0        No control panel or delete limit. Bug where it keeps a
  59.      5/4/92        lock on the  directory it is started from. Dropping
  60.             a disk icon on the appicon doesn't cause an error
  61.     (not released)      condition.Takes about 3 disk swaps if deleting stuff
  62.             from 2 disks on a single drive machine. Can't cope with
  63.             lone icons (just a .info file).
  64.  
  65.     v1.1        Font sensitive control panel added which opens up over
  66.      4/5/92        the mouse pointer. Tries to reduce disk swaps.
  67.             Messes up slightly with requesters when one file is on a
  68.             disk that is not mounted. Can save preferences into the
  69.             tooltypes of the icon. Snapshot doesn't work - I can't
  70.             find a way of getting the position of the icon. If
  71.             anyone knows how, tell me!
  72.  
  73.  Future Improvements
  74.  -------------------
  75.  
  76.     (Probable)          Allow user to specify some CLI command to run on each
  77.             file before deleting it (e.g. an archiver).
  78.             Dropping a disk icon could call up sys:system/format??
  79.  
  80.     (Insane)            locale.library support (I only speak English). Scaleable
  81.             checkboxes instead of gadtools' fixed size ones.
  82.  
  83.  About the author
  84.  ----------------
  85.  
  86.  Alan Singfield, 81 Croxteth Dr. Rainford, Merseyside, WA11 8LA, ENGLAND.
  87.  At the moment I am revising for my A-levels, so I'm !(having a great time). For
  88.  anyone who doesn't want to know, I am doing Pure & Applied Maths, Physics and
  89.  an AS-level in Electronics. This October, I will be going to Manchester
  90.  University to do a degree in Computer Science (what else...) My favourite
  91.  colour is green, and I like listening to The Smiths, The Orb and My Bloody
  92.  Valentine.
  93.  
  94.  About the program
  95.  -----------------
  96.  
  97.  Blackhole is written using DICE C, with the text editor DME. It is totally
  98.  Public Domain, and can be copied and distributed as long as it is kept with all
  99.  it's accompanying files. If you use it though, please send me a disk or two of
  100.  PD software. In return, I will send you my favourite PD stuff.
  101.  You are quite welcome to plagarise bits from the source code, just stick my
  102.  name somewhere in the credits.
  103.  
  104.  My system is a 2MB chip ram A500+, with an extra floppy and a TV (euurgh!). I
  105.  use a beta version of Workbench 2.1 (38.12) which is quite stable apart from
  106.  the asl.library.
  107.  
  108.  Credits
  109.  -------
  110.  
  111.  Thanks to Matt Dillon for DICE itself, and a few bits of code and techniques I
  112.  have copied from his editor DME. The control panel is based on Gadtools2.c from
  113.  the AmigaMail disk supplied with the v2.0 Native Developer Kit.
  114.  
  115.  Thanks to Howard Mansell for some good ideas!! (Your name in print, Sheep Fan!)
  116.  
  117.  
  118.